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— SUBJECT CP-6 I/O System (10Q) 


1. INTRODUCTION 


The CP-6 I/0 System (I0Q) will provide all input-output 
facilities for disk storage, magnetic tape, local card 
readers and punches, local line printers, and the system 
console. In addition, it wiil provide connect and interrupt 
facilities for the direct channel to the L6 Front End. 


This document describes the reiease version of I0Q. For 
initial testing there will be an interim version based on 
GCOS IOS. This interim version will have the Monitor 
interfaces described in Sections 2, 3, and 4, but it will not 
have all of the error recovery or Test and Diagnostics (T&D) 
facilities described in Sections 5 and 6. As I0Q evolves 
from the interim version to the release version, these 
facilities will be added. 


Sections 2, 3, and 4 describe the interface which will be 
used for all normal I/0, i.e., all I/0 except T&D. Section 2 
is a functional overview, Section 3 describes the I/0 request 
packet, and Section 4 describes the calling sequences. 


Section 5 describes the error recovery and logging techniques 
to be used by I0Q. 


Section 6 describes the T&D interface to I0Q. 
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NCTIONAL OVERVIEW OF "NORMAL-MODE" R 


Functionally the services provided by CP-6 I0Q are similar in 
nature to the CP-V I0Q services. Callers specify logical 
function codes and device indices along with buffer 
description and end-action information. I0Q then calls a 
device pre-handler to build the command list needed to 
perform the operations, starts the I/0, and upon completion 
reports the type completion code to the caller via the user's 
DCB or end-action routine. The major function differences 
arise from the way information is passed to and returned from 
I0Q. 


In CP-6, the I0Q tables consist of a pool of queue entry 
packets. To issue an I/O request one first requests a free 
queue entry or packet. The request routine returns a PL-6 
pointer to the packet, which the caller uses with a based 
structure template to stuff the packet. The pointer to the 
packet is then passed to the queuing routine which processes 
the request. After post-processing of the I/0 operation 
completion, if end-action was requested by the caller, the 
packet (now including completion status like type completion 
and actual record size) is passed to the end-action routine. 
Upon return from the end-action, the packet is either freed 
or re-queued, depending on a flag set by the end-action 
routine. 


The second source of difference arises from a generalization 
of the AVR service in CP-V. On the L66 system all devices 
generate special interrupts - interrupts not necessarily the 
result of an I/0 operation - such as when a device changes 
state from manual to ready. In CP-6, I0Q will provide a 
generalized service allowing monitor routines to gain control 
of these interrupts on a selective basis by device index. 


IOQ provides for both mapped and non-mapped I/0, either 
user-associated or not, wait or no-wait service, DCB posting, 
event posting, end-action control, and special interrupt 
control. The following sections describe each of these 
services. 


Non-User Associated I/0 


This service is exactly like CP-V's NEWQNW. No system 
scheduler service is involved, the I/O is always queued and 
an immediate return made to the caller. At completion, the 
specified end-action routine is called. Using a buffer 
pointer format of BUFPPNO, any page in the first 16M words of 
real memory may be addressed. It is also possible to perform 
non-user associated I/0, using a users map (such as for 
"swapping"). The use of a map for the I/0 is dependent only 


2.3 


2.4 
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on the descriptor of the buffer as referenced by the PL-6 
pointer. Non-user associated requests imply no system 
scheduler interfaces and no posting of status in a DCB. 


User-Associated I/0 


This service provides an interface which is a logical 
combination of NEWQ and QUEUE. User-associated I/O implies 
system scheduler interfaces such as Master Function Count 
check and the possibility of services like waiting on the I/0 
operation, posting status in the user's DCB and reporting 
event completion. Master Function Count check is always 
performed for user-associated I/0 resulting in blocking the 
user if he has exceeded the master function limit for his job 
class (online or batch). The other functions of this service 
request are selectively enabled by bit flags in the request 
packet or by the parameters of the call. (See Section 4. - 
Calling Sequences - for details.) 


Speciai Interrupt Control 


The device tables will contain the address to which control 
will be transferred upon receipt of special interrupts. This 
address may be separately established for each device by a 
cali on I0Q specifying the device index (DCTX) and the entry 
point to which control is to be passed. At the time of a 
special interrupt, if such control has been established, the 
DCTX and the interrupt status word will be passed to the 
specified address for processing. The special interrupt 
request will remain in effect until an explicit call is made 
to I0Q to disable the request. 


It is conceivable that a monitor service could be provided to 
allow a user to get control (a la M:INT) for special 
interrupts on a device currently allocated to him. 


Cleanup of User-associated I/0 


There will be an entry provided to clean up all I/0 fora 
user job when that job terminates. 
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3% QUEUE PACKET FORMAT 

DCL 1 NISREQ BASED ALIGNED, /* I/O REQUEST PACKET #*/ 


0123456780123456780123456.7 801234567 8 


i 
2) ' BUFSIZE 1, FC 1OPFLG 
1 4 i 


UiAIEFE:rWiBrHiRis 


10 | |EVNTINFO 
Komen ceawe en mas tia tehc aman aa aaa ea eaee eae a= 


11) | ARSIZE 


ne 


LEVEL 2 ARRAY: oes A 6'O) ENTRIES TOTAL. 


sol pool i SECTOR 


26 | ‘STATUS 1 
me Pi:MAJOR jMINOR ce 110M Be iRCR 
ee eee ieee aebesasaeees | 
27 | ' STATUS2 
iNXTADDR iNXTCHiR;* 
{ 


NM 


Mm MT fh fo 


Ae) 


MMM MM MM NM NP 


MP PM Po 


MM MP 


fh PO 


FL$ PTR, 

DLA ALIGNED, 

3 SETX UBIN(9) UNAL, 

3 SETADDR UBIN(27) UNAL, 
BUFSIZE UBIN(20) UNAL, 

* BIT(1) UNAL, 

FC UBIN(6) UNAL, 

OPFLG, 

3 USER BIT(1) UNAL, 

3 ARS BIT(1) UNAL, 

3 EVNT BIT(1) UNAL, 

3 EA BIT(1) UNAL, 

3 WAIT BIT(1) UNAL, /* BLOCK 
3 BPF BIT(1) UNAL, 

3 HOLD BIT(1) UNAL, 

3 REQ BIT(1) UNAL, 

3 SET BIT(1) UNAL, 

BUFS PTR, 


PTP UBIN(18) UNAL, 
* SBIN HALF UNAL, 
DCBS PTR, 
EAENTRY EPTR, 
EAINFO UBIN(36), 
EVNTINFO UBIN(36), 
ARSIZE UBIN(20) UNAL, 
* BIT(1) UNAL, 
CC, 
3 ERR, 
4 IO BIT(1) UNAL, 
4 PE BIT(1) UNAL, 
4 INVD BIT(1) UNAL, 
3 ABN, 
4 EOF BIT(1) UNAL, 
4 EOT BIT(1) UNAL, 
4 BOT BIT(1) UNAL, 
USER# UBIN(9) UNAL, 
ARCT SBIN UNAL, 
RCT SBIN UNAL, 
LPWX ALIGNED, 
3 BASE UBIN(18) UNAL, 
3 SIZE UBIN(18) UNAL, 
SCT UBIN(18) UNAL, 
ADCW2 UBIN(18) UNAL, 
DCWLIST(0:5) UBIN(36), 
SEEK ALIGNED, 
3 SCL UBIN(12) UNAL, 
3 SSZ UBIN(4) UNAL, 
3 SECTOR UBIN(20) UNAL, 
CL$ PTR, 
SYATUS1 ALIGNED, 
3 PRESENCE BIT(1) UNAL, 


AS 
/*® 
/*® 
/*® 
/* 
/® 
/*® 
/* 


/* 
/* 
/* 
/*® 
/* 


/* 


/*® 
/* 
/* 


/* 
/* 
/* 
/* 
/*® 
/* 
/* 
/* 
/* 
/* 
/*® 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
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LINK TO NEXT PACKET IN QUEUE */ 
DEVICE LOGICAL ADDRESS #*/ 

DEVICE OR SET INDEX */ 

DEVICE- OR SET-RELATIVE ADDRESS #*/ 
BUPFER SIZE (BYTES) '*7 


LOGICAL FUNCTION CODE */ 
OPERATION FLAGS */ 
USER-ASSOCIATED I/O */ 

SET -ARS.-OF “DCB: */ 

REPORT COMPLETION EVENT #*/ 
CALL END-ACTION ROUTINE */ 


SOCIATED USER AFTER QUEUEING REQUEST 


BUF$ CONTAINS PTR => BUFFER ¥*/ 

DO NOT RELEASE PACKET ON COMPLETION 
RE-QUEUE PACKET */ 

OsREQ ‘TO DEV, TEREQ TO. SET *7 

"BUPS PIER" “IF BPRs "1° 8 #7 

"BUFADDR UBIN( 26)" IF BPF=s"0'B. */ | 
BPF=0: PAGE TABLE POINTER (OSREAL): * 


-> USER'S DCB */ 
END-ACTION PROCEDURE */ 
END-ACTION PARAMETER */ 
EVENT INFO */ 

ACTUAL RECORD SIZE */ 


LOGICAL COMPLETION CODE (9=0K) */ 
I/O ERROR */ 


PARITY ERROR ¥*/ 
INVALID OPERATION */ 


END-OF-FILE */ 

END-OF-TAPE */ 
BEGINNING-OF-TAPE ¥*/ 

USER ID */ 

ACTUAL RECORD COUNT */ 

RECORD COUNT */ 

LIST POINTER WORD EXTENSION */ 
LOWER BOUND (MOD 2 WORDS) */ 
SIZE (WORDS) */ 

DEVICE TABLE ADDRESS #*/ 
ADDRESS OF SECOND DCW LIST #*/ 
DCW LIST -*/ 

DISK SEEK ADDRESS WORD */ 
SECTOR COUNT LIMIT *7 

SECTOR: SIZE. */ 

SEEK ADDRESS ¥*/ 

LINK TO DCW LIST PACKETS */ 
STATUS WORDS ¥*/ 


POWEROFF BIT(1) UNAL, 
MAJOR BIT(4) UNAL, 
MINOR BIT(6) UNAL, 

* BIT(6) UNAL, 

IOM BIT(6) UNAL, 

* BIT(6) UNAL, 

RCR UBIN(6) UNAL, 
STATUS2 ALIGNED, 


WWW WW oY 


3 NXTADDR UBIN(18) UNAL, 


3 NXTCHAR UBIN(3) UNAL, 
3 READFLG BIT(1) UNAL, 
3 * BIT(14) UNAL; 
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POWER OFF STATUS */ 
DEVICE MAJOR STATUS */ 
DEVICE MINOR STATUS */ 


IOM / CHANNEL STATUS */ 


RECORD COUNT RESIDUE */ 
2ND STATUS WORD */ 

NEXT ABS ADDRESS */ 
NEXT CHAR POSITION */ 
READ/WRITE FLAG */ 
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DCL 1 NI$SVREQ BASED ALIGNED, /* I/O REQUEST PACKET #*#/ 


012345678012345678012345678012345 67 8 


iFC 1OPFLG 
: tales 


11 ‘ARSIZE 
! 
: 


BASE 


‘LEVEL 2 ARRAY: 6 (! 670) ENTRIES TOTAL. 
i 


= ae > ow ow om OP o® o® © oO o® ow ow oe oe i — = ow oe o® © om Ow o® @ @® @® ow oo we t —— on we ow ow ow oe we @ oe ow wo @ oe 


‘SCL 1902 i SECTOR 


26} ‘STATUS 1 
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=e SSeS sees | en mn ren fre mr erent errs nn fl mre rar t errr lane 
27 | : STATUS2 

iINXTADDR iNXTCHiRi* 


fh —M 


NM MP P 


PhO 


mM MM PM PM MM PN PP 


Mh NMP M 


NNO PM PO 


N 


FL$ PTR, 

DLA ALIGNED, 

3 DCTX UBIN(9) UNAL, 

3 DRELADDR UBIN(27) UNAL, 
BUFSIZE UBIN(20) UNAL, 

* BIT(1) UNAL, 

FC UBIN(6) UNAL, 

OPFLG, 

3 USER BIT(1) UNAL, 

ARS BIT(1) UNAL, 

EVNT BIT(1) UNAL, 

EA BIT(1) UNAL, 

WAIT BIT(1) UNAL, /* 
BPF BIT(1) UNAL, 

HOLD BIT(1) UNAL, 

REQ BIT(1) UNAL, 

SET BIT(1) UNAL, 
BUFADDR UBIN(26), 


tw WD WW LW WL) WW OO 


PTP UBIN(18) UNAL, 
* SBIN HALF UNAL, 
DCB$ PTR, 
EAENTRY EPTR, 
EAINFO UBIN(360), 
EVNTINFO UBIN(36), 
ARSIZE UBIN(20) UNAL, 
* BIT(1) UNAL, 
CC, 
3 ERR, ~ 
4 IO BIT(1) UNAL, 
4 PE BIT(1) UNAL, 
4 INVD BIT(1) UNAL, 
2 ABN, 
4 EOF BIT(1) UNAL, 
4 EOT BIT(1) UNAL, 
4 BOT BIT(1) UNAL, 
USER# UBIN(9) UNAL, 
ARCT SBIN UNAL, 
RCT SBIN UNAL, 
LPWX ALIGNED, 
3 BASE UBIN(18) UNAL, 
3 SIZE UBIN(18) UNAL, 
SCT UBIN(18) UNAL, 
ADCW2 UBIN(18) UNAL, 
DCWLIST(0:5) UBIN(36), 
SEEK ALIGNED, 
3 SCL UBIN(12) UNAL, 
3 SSZ UBIN(4) UNAL, 
3 SECTOR UBIN(20) UNAL, 
CL$ PTR, 
STATUS1 ALIGNED, 
3 PRESENCE BIT(1) UNAL, 


/* 
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LINK TO NEXT PACKET IN QUEUE */ 
DEVICE LOGICAL ADDRESS */ 

DEVICE OR SET INDEX */ 

DEVICE- OR SET-RELATIVE ADDRESS */ 
BUFFER SIZE (BYTES) */ 


LOGICAL FUNCTION CODE */ 
OPERATION FLAGS */ 
USER-ASSOCIATED I/0 */ 

SET ARS OF DCB */ 

REPORT COMPLETION EVENT */ 
CALL END-ACTION ROUTINE */ 


RLOCK ASSOCIATED USER AFTER QUEUEING REQUEST * 


BUFS CONTAINS PTR -> BUFFER ¥*/ 

DO NOT RELEASE PACKET ON COMPLETION * 
RE-QUEUE PACKET */ 

H=REO TO DEV,. 1=REQ TO SET */ 

"BUFS PTR" IF BPF='1'B *¥/ 

"BUFADDR UBIN(26)" IF BPF='0'B */ 
BPF=0: PAGE TABLE POINTER (O=REAL) *, 


-> USER'S DCB */ 
END-ACTION PROCEDURE */ 
END-ACTION PARAMETER */ 
EVENT INFO */ 

ACTUAL RECORD SIZE */ 


LOGICAL COMPLETION CODE (0=0K) */ 


I/O ERROR 7 
PARITY ERROR */ 
INVALID OPERATION */ 


END-OF-FILE */ 

END-OF-TAPE */ 
BEGINNING-OF-TAPE */ 

USER ID */ 

ACTUAL RECORD COUNT */ 

RECORD COUNT */ 

LIST POINTER WORD EXTENSION */ 
LOWER BOUND (MOD 2 WORDS) */ 
SIZE (WORDS) */ 

DEVICE TABLE ADDRESS */ 
ADDRESS OF SECOND DCW LIST */ 
DEW LIST -*/ 

DISK SEEK ADDRESS WORD */ 
SECTOR COUNT LIMIT */ 

SECTOR SIZE */ 

SEEK ADDRESS */ 

LINK TO DCW LIST PACKETS */ 
STATUS WORDS */ 


POWEROFF BIT(1) UNAL, 
MAJOR BIT(4) UNAL, 
MINOR BIT(6) UNAL, - 

* BIT(6) UNAL, 

IOM BIT(6) UNAL, 

* BIT(6) UNAL, 

RCR UBIN(6) UNAL, 
TATUS2 ALIGNED, 
NXTADDR UBIN(18) UNAL, 
NXTCHAR UBIN(3) UNAL, 
READFLG BIT(1) UNAL, 
* BIT(14) UNAL; 


WW WWW WWW) WO WD 
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POWER OFF STATUS */ 
DEVICE MAJOR STATUS */ 
DEVICE MINOR STATUS ¥*/ 


IOM / CHANNEL STATUS */ 


RECORD COUNT RESIDUE */ 
2ND STATUS WORD */ 

NEXT ABS ADDRESS */ 
NEXT CHAR POSITION */ 
READ/WRITE FLAG */ 


Logical Function Codes 


NAME 


NI_RQSTAT 
NI_RDBIN 
NI_RDASC 
NI_WRBIN 
NI_WRASC 
NI_WRCMP 
NI_WRASCED 
NI_ ALARM 
NI SLEW 
NI_LDVFC 
NI_LDCHAIN 
NI_RDSTREG 
NI_RDEBC 
NI_WREBC 
NI WREM 
NI_SPREC 
NI SPFILE 
NI_SD&00 
NI_SD1600 
NI_SD6250 
NI REWIND 
NI UNLOAD 
NI PERMIT 
NI_ PROTECT 


DEFINITION 


Request status 

Read binary 

Read ASCII 

Write binary 

Write ASCII 

Write and compare 
Write ASCII edited 
Turn on operator alarm 
Slew 

Load VFC image 

Load print chain image 
Read status register 
Read EBCDIC 

Write EBCDIC 

Write file mark 
Space records 

Space files 

Set density=800 

Set density=1600 

Set density=6250 
Rewind 

Rewind and unload 
Tape write permit 
Tape write protect 
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CR CP LP DP MT SC 


X X X 
X 
X 
X 
X X 
X 
X 
X 
X 
X 


X xX 

X 

X xX 

X 

X X 
X 


PS PS PS PS PS PS PK PK DR OK OOK OOS OOK 
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The status codes with "TYC" in the type column have a 
one-to-one correspondence with bits in the TYC field of DCB 


and will be reported therein. 


4.2 


4.3 
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CALLING SEQUENCES 


NIQSGET 


Call form: 


CALL NIQ$GET(Q$); 


Purpose: 


NIQ$GET obtains a pointer to a queue entry packet. The 
queue format is described in Section 3. A based 
structure is used by the requesting routine to fill in 
the appropriate information. 


If no packets are available and there is a current user, 
a "no packet available" event will be reported to the 
scheduler and the user will be blocked. If there is no 
current user, NIQSGET will loop, trying to start 1/0, 
until a packet becomes available. 


NIQS$REL 


Call form: 


CALL NIQ$REL(Q$); 


Purpose: 


NIQ$REL frees the packet specified by Q$. This routine 
would normally be used only by I10Q, but others could use 
1.0% 


If this packet is now the only available packet the 
scheduler is called to report "qiveue packet available". 


NIOSDEVIO 


Call form: 


CALL NIOSQUE(QS)ALTRET( label); 


where Q$ is the PTR returned from a call on NIQSGET. 


Purpose: 


NIO$DEVIO queues a request for I/O on a particular 
logical device index (DCTX). 


4.5 
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To issue an I/0 request, one calls NIQ$GET which returns a 
pointer to the queue packet to be used. Various fields of 
the queue packet (as described by a based structure) must be 
filled in specifying the operation to be -pertormed. (See 
Section 3.) 


Tne alternate return is taken if: 


e) DCTX is not a valid device table index. 
fe) DRELADDR is not a valid address on this disk. 
re) FC is not a valid logical function code. 


In addition to the above reasons, the alternate return is 
taken: if OPFLG.SET ‘= -"1'B. and: 


fo) SETX is not a valid pack set index. 


fe) SRELADDR is not a valid address in this packet set. 


End-Action Routine 
Call form: 

CALL EAENTRY(Q$); 
where: 


EAENTRY is the end action routine specified in the queue 
packet. 


Q3 is a PL-6 pointer to the queue packet. 


When the end-action routine is called, the buffer address 
will be in BUFADDR and PTP of the queue packet and OPFLG.BPF 
Will be set to ‘'1'B. 


OPFLG.REQ in the queue packet will be set to '0'B by I0Q. 
The end action routine may set this flag to '1'B to indicate 
to I0Q that the packet is to be requeuved. If OPFLG.REQ is 
set to '0'B, the disposition of the packet is controlled by 
OPFLG.HOLD. If the latter is '1'B, the packet will not be 
released. In this case, it is up to the caller to release 
the packet when he is done with it. 7 


Scheduler Interfaces 


IOQ interfaces with the scheduler to provide three basic 
functions. These are: 
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fe) Ability to wait on user associated I/0. This means that 


the call on NIOSDEVIO or NIOSSETIO does not return until 
the I/O operation is completed. 


fe) Ability to limit the number of outstanding I/O requests 
for a user. This check - called Master Function Check - 
is always invoked for user associated I/O and causes the 


user 


to be blocked until previous requests complete. 


The I/O request which causes the block is not queued 
until after the scheduler determines that the Master 
Function Count is below the users threshold. 


fe) Ability to cause asynchronous reporting of an I/0 
complete event to the user's program. 


fe) Report that no queue packets are available. The current 


user 


is to be blocked until a queue packet becomes 


available. 


fo) Report that a queue packet is now available. This 
allows the scheduler to unblock all users who were 
previously blocked for lack of a queue packet. 


The calls 


CALL 


CALL 


CALL 


to the scheduler to provide these functions are: 
SSRS$REG(SS IIP,DCB$); 


Place the current user in the I/O in progress state 
until I/O complete occurs. 


SS_IIP is the I/O In Progress event code. 
DCB$ is the PL=-6 PTR to the user's DCB. 
SSRSREG(SS_QMF); 


Block the current user because his Master Function 
Count is exceeded. 


SS_QMF is the Queue for Master Function event code. 


SSR$RUEC(LSS_IOC,SS_ IOCU],USR#,DCBS,EVNTIFO); 


Report I/0 complete event to the scheduler. 
SS_IOC is the I/O Complete event code. 


SS_IOCU is the I/O Complete and unblock event code. 
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USR# is the user# of the user associated with the 
TIO 


DCB$ is the PL-6 pointer to the user's DCB. 
EVNTINFO is 72 bits of information including TYC 
and the user's EVNTINFO to be reported to the user 
asynchronously. 


CALL SSR$REG(SS_NQP); 


Block the current usSer when no queue packets are 
available. 


CALL SSR$RE(SS_QPA); 
Unblock all users who were blocked for lack of a queue 
packet. 
Request for Special Interrupt Control 
Call form: 
CALL NIOSSPINTCON(DCTX, INTADDR, EAINFO)ALTRET(label); 
where: 


DCTX is the logical device index for which special 
interrupt control is requested. 


INTADDR is the procedure name (as a PL-6 entry pointer) 
to which control is to be transferred when a special 
interrupt occurs on this device. This address must be 
within the monitor's instruction segment. The special 
interrupt request remains in effect until it is cleared 
by a call to NIO$SPINTCON with EADDR=NULL. 


FAINFO is a data word to be passed to the special 
interrupt end action routine. 


The alternate return is taken if: 
e) DCTX is not a valid device table index. 
fe) The device does not generate special interrupts. 


fe) Special interrupts are already requested for the device. 
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4.7 Special Interrupt End Action Routine 
Call form: 


CALL INTADDR(DCTX,INTSTAT, EAINFO); 
where: 


INTADDR is the end-action routine specified in the call 
to NIO$SPINTCON. 


DCTX is the device index of the interrupting device. 
INTSTAT contains a logical status code indicating the 
ao of special interrupt that occurred. See Section 
4.8 Clean Up All User I/0 

Call form: 

CALL NIS$ABIO(CUSR#); 
where: 

USR# is the user number. 

Purpose: 


Abort and clean up all I/O associated with the specified 
user. 


SF section: 14 


doc # : 0160B-2 
date : 771108 
page : 17 


ERROR RECOVERY AND LOGGING 


Error Recovery 

IO0Q will perform all error recovery for normal I/O requests. 

The action taken depends on the device type and the status 

returned from the I/O operation. 

Basically there are five distinct types of status which may 

occur during an I/O operation. These are listed in the 

following paragraphs with examples and action taken. 

Normal Completion 

Example: 
Channel Ready 

Action: 
This the normal completion of an I/O request; a normal 
completion code is returned to the caller (i.e., to the 
DCB and/or end-action routine). This category includes 
status codes that indicate that the MPC (microprogrammed 
controller) firmware corrected an error. 

Data/User Error 

Example: 
Mispunched ASCII card, blank tape read. 

Action: 
No recovery can be performed; a completion code 
indicating the type of error will be returned to the 
caller. 

Read/wWrite/Transmission Error 

Examples: 


Tape parity error, disk checkword error, channel parity 
error. 
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ERROR RECOVERY AND LOGGING 


Error Recovery 
IO0Q will perform all error recovery for normal I/0 requests. 
The action taken depends on the device type and the status 
returned from the I/0 operation. 
Basically there are five distinct types of status which may 
occur during an I/0 operation. These are listed in the 
following paragraphs with examples and action taken. 
Normal Completion 
Example: 
Channel Ready 
Action: 
This the normal completion of an I/O request; a normal 
completion code is returned to the caller (i.e., to the 
DCB and/or end-action routine). This category includes 
status codes that indicate that the MPC (microprogrammed 
controller) firmware corrected an error. 
Data/User Error 
Example: 
Mispunched ASCII card, blank type read. 
Action: 
No recovery can be performed; a completion code 
indicating the type of error wiil be returned to the 
caller. 
Read/Write/Transmission Error 


Examples: 


Tape parity error, disk checkword error, channel parity 
error. 
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Action: 


There are a variety of recovery techniques that may be 
used depending on the device type and the nature of the 
error. In some cases, the MPC for the device will retry 
the operation several times. If one of these retries is 
successful, a normal completion status will be returned 
to the CPU (see Section 5.1.1). If not, I0Q will 
perform recovery sequences which include additional 
retries. If one of these retries is successful, a 
normal completion code will be returned to the caller. 
If not, an unrecoverable error completion code will be 
returned to the caller. 


5.1.4 Device Requires Operator Intervention 
Examples: 
Card reader hopper empty, line printer paper jam. 
Action: 
This type of status is divided into two sub-categories: 


1) Those conditions that the operator can correct such 
as a card reader hopper empty condition. For these 
conditions, I10Q will notify the operator of the 
problem, wait for the special interrupt signifying 
that the device is ready, then retry the I/0 
operation. 


2) Those conditions which may also require action by 
the calier, such as a iine printer paper jam. For 
these conditions, I0Q will notify the operator and 
return an error completion code to the caller. The 
caller, usuaily a symbiont, can then conduct his 
own dialogue with the operator, reposition the 
print file, if necessary, and reissue the I/0 
request. (I0Q will wait for the special interrupt 
Signifying that the device is ready before issuing 
the I/O request to the device.) 


5.1.5 Software Errors 
Example: im 


Invalid instruction sequence. 


5.2 
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Action: 


This type of status response to an I/O operation can 
only be caused by software errors in I0Q; it wiil cause 
a system crash. : 


Error Logging 


In order to provide both immediate device error information 
as well as a record for later analysis, I0Q will keep a 
device error log as part of the system error log. It will 
contain two types of entries: 


1) Every error status received will be logged, including 
those that indicate that the MPC successfully corrected 
an error. This type of entry will contain a time stamp, 
the external device ID, the IOM number, channel number, 
and MPC ID, the IDCW, the status word or doubleword, any 
other status information available, such as the extended 
Status bytes generated by the unit record equipment, and 
the volume ID, if applicable. 


2) Whenever a tape or disk volume ID is dismounted and 
periodically, if a volume remains mounted for an 
extended period of time, the device operation statistics 
will be read from the MPC and logged. This type of 
entry will include a time stamp, the external device ID, 
the MPC ID, the volume ID, and the device operation 
Statistics. 
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TEST AND DIAGNOSTICS (T&D) 


The T&D interface to I0Q will provide direct access to 
peripheral devices, MPCs, and IOMs (Input-Output 
Multiplexors) so that preventive and emergency maintenance 
can be performed on devices that have been partitioned out of 
the active system. This interface will be implemented so 
that a hardware diagnostic program can be a user job running 
in slave mode. The interface will allow the caller to 
specify: 


re) The device to be tested (external device ID), 
O The path to that device (IOM number, channel number), 
and 


fe) The PCW (Peripheral Control Word) and channel program to 
be issued to the device. 


On completion of the request, the T&D interface will return 
the status doubleword and the contents of the channel's 
maiibox, whether in scratchpad or in memory, to the caller. 
No error recovery will be performed. If a special or fault 
interrupt occurs for the specified channel during the 
request, the status word from that interrupt will be returned 
to the caller, terminating the request. 


The T&D interface will check all requests to ensure that 
system security is not compromised: 


) Perpheral Device Access 


The requested device must be partitioned out. (T&D 
cannot be performed on a device which is available to 
CP-6.) The interface will set the device number field 
in each IDCW so that only device commands will be 
accepted by the hardware. 


fe) MPC Access 


The requested MPC (i.e., all channels connected to that 
MPC) must be partitioned out. Device commands will be 
accepted only if they refer to devices which are 
partitioned out. 


fe) IOM Access 
The T&D interface will allow access to the snapshot, 
wraparound, and scratchpad access channels. The PCWs 
will be checked to ensure that only partitioned-out 
channels are accessed. 


